home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / earcd / util / sys / msys_1_2.lha / Doc / makelink.doc < prev    next >
Text File  |  1996-02-10  |  3KB  |  70 lines
  1. C/MakeLink                                                         C/MakeLink
  2.  
  3.    NAME
  4.        MakeLink -- create filesystem links. (V42)
  5.  
  6.    SYNOPSIS
  7.        MakeLink Source Target [HARD] [SOFT] [FORCE]
  8.  
  9.    TEMPLATE
  10.        MakeLink "FROM/A,TO/A,HARD/S,SOFT/S,FORCE/S"
  11.  
  12.    FUNCTION
  13.        MakeLink creates links to other files or directories. A link is a
  14.        directory entry that points to other file or directory. There are
  15.        two kinds of links:
  16.            hard links - this link points to an already existing file or
  17.                         directory located on the same partition;
  18.            soft links - such links may point to any objects (including
  19.                         devices, volumes, and partitions) and as such are
  20.                         more flexible.
  21.        MakeLink creates a Source name link that points to Target. HARD
  22.        options (default) indicates that it is a hard link. SOFT option
  23.        indicates a soft link. You can't specify both HARD and SOFT. When
  24.        creating hard links to directories FORCE option must be given.
  25.        MakeLink detects circular (i.e. to parent directories) dependencies
  26.        during creation of hard links and will not create such links.
  27.  
  28.    INPUTS
  29.        Source - name of symbolic link to create.
  30.        Target - name of link target. In case of hard links must be an
  31.                 existing directory or file name.
  32.        HARD   - indicates hard link (default).
  33.        SOFT   - indicates soft link.
  34.        FORCE  - this keyword must appears during creation of hard links to
  35.                 directories, ignored for soft links.
  36.  
  37.    RESULT
  38.        RETURN_FAIL  - if 'dos.library' couldn't be opened or command line
  39.                       arguments couldn't be processed or both HARD and SOFT
  40.                       options appeared on command line.
  41.        RETURN_ERROR - circular dependency was detected (ERROR_OBJECT_LINKED),
  42.                       link couldn't be created or some other error.
  43.        RETURN_OK    - if a link was created.
  44.  
  45.    EXAMPLE
  46.        MakeLink SYS:Utilities/More C:PPMore
  47.            ; Creates SYS:Utilities/More file that in reality is the C:PPMore.
  48.        MakeLink DF0.link DF0: SOFT
  49.            ; Creates DF0.link pseudo-directory which points to a disk in
  50.            ; DF0: drive.
  51.        MakeLink Work:Music/Lyrics Work:Docs/Lyrics FORCE
  52.            ; Creates Work:Music/Lyrics directory which points to
  53.            ; Work:Docs/Lyrics
  54.  
  55.    NOTES
  56.        Links (especially soft) are not fully supported in current AmigaDOS
  57.        releases. This is why soft links - even pointing to files - will
  58.        look like directories to most of the programs. Creating soft links
  59.        to handlers (like SPEAK:) may yield very strange results.
  60.        MakeLink is pure and can be made resident.
  61.  
  62.    BUGS
  63.        In FastFileSystem before version 40 when referencing a soft link it
  64.        must be the last part of the path. There is also a bug regarding
  65.        removing the target of the hard link (in FastFileSystem, too).
  66.  
  67.    SEE ALSO
  68.        dos.library/MakeLink().
  69.  
  70.